PROMO Protocol API
About
An MCP-enabled DVM for the PROMO Protocol API
Author
npub1qqptkq9cue9m9gpn3qsfk6u6yhydw30qtx4u4xur69n28ls7mukq8sgnt3
mcpget-metrics-by-billboard-idget-function-perfomance-by-name
Capabilities
mcp-1.0
Event ID: 45d841d591dbf0e5c6217d180de7aaf7f4363b4872564b62dc902672e60d95db
PROMO Protocol API
Installation Options
You can install and run this DVM locally using the @dvmcp/discovery package. Choose one of the following methods:
Option 1: Using Server Flag
Run with the server's naddr:
Command
npx @dvmcp/discovery --server naddr1qvzqqqru7cpzqqqzhvqt3ejtk2sr8zpqnd4e5fwg6az7qkdte2dc85tx50lpahevqyt8wumn8ghj7un9d3shjtnywekkxupwve6kutcq9fj8vmfdv9hxumm4de3k2mt9de6z65zjfax57gzswfhhgmmrdakzqs2sfysyxmrfv4h8g9fef2r
JSON Configuration
"mcpServers": {
"promo-protocol-api": {
"command": "npx",
"args": [
"@dvmcp/discovery",
"-y",
"--server",
"naddr1qvzqqqru7cpzqqqzhvqt3ejtk2sr8zpqnd4e5fwg6az7qkdte2dc85tx50lpahevqyt8wumn8ghj7un9d3shjtnywekkxupwve6kutcq9fj8vmfdv9hxumm4de3k2mt9de6z65zjfax57gzswfhhgmmrdakzqs2sfysyxmrfv4h8g9fef2r"
]
}
}
This command uses the naddr which encodes the event kind, public key, and the 'd' tag of the event. It will get the tools just from this server.
Option 2: Using Provider Flag
Run with the provider's nprofile:
Command
npx @dvmcp/discovery --provider nprofile1qyt8wumn8ghj7un9d3shjtnywekkxupwve6kutcqyqqq9wcqhrnyhv4qxwyzpxmtngju3469upv6hj5ms0gkdgl7rm0jc9alwsn
JSON Configuration
"mcpServers": {
"promo-protocol-api": {
"command": "npx",
"args": [
"@dvmcp/discovery",
"-y",
"--provider",
"nprofile1qyt8wumn8ghj7un9d3shjtnywekkxupwve6kutcqyqqq9wcqhrnyhv4qxwyzpxmtngju3469upv6hj5ms0gkdgl7rm0jc9alwsn"
]
}
}
This command uses the nprofile which encodes the public key and relay hints. It will get all tools from this provider.
What Happens Next?
After running one of the commands above:
- The discovery package will fetch the DVM configuration from the Nostr network
- It will start a local server running this DVM
- You can then interact with the DVM through your local instance
Try it out
Form Values
{"name":"get-metrics-by-billboard-id","parameters":{}}Form Values
{"name":"get-function-perfomance-by-name","parameters":{}}{
"created_at": 1745602897,
"content": "{\"name\":\"PROMO Protocol API\",\"about\":\"An MCP-enabled DVM for the PROMO Protocol API\",\"picture\":\"https://image.nostr.build/5bf2e2eb3b858bf72c23e53ed1f41ed0f65b2c8a805eaa48dd506b7cfec4ab88.png\",\"website\":\"https://github.com/joinnextblock/promo-protocol/tree/main/packages/promo-api\",\"tools\":[{\"name\":\"get-metrics-by-billboard-id\",\"description\":\"returns metrics for a billboard\",\"inputSchema\":{\"type\":\"object\",\"properties\":{\"billboard_id\":{\"type\":\"string\"}},\"required\":[\"billboard_id\"],\"additionalProperties\":false,\"$schema\":\"http://json-schema.org/draft-07/schema#\"}},{\"name\":\"get-function-perfomance-by-name\",\"description\":\"get function perfomance by name\",\"inputSchema\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\"}},\"required\":[\"name\"],\"additionalProperties\":false,\"$schema\":\"http://json-schema.org/draft-07/schema#\"}}]}",
"tags": [
[
"d",
"dvm-announcement-PROMO Protocol API Client"
],
[
"k",
"5910"
],
[
"capabilities",
"mcp-1.0"
],
[
"t",
"mcp"
],
[
"t",
"get-metrics-by-billboard-id"
],
[
"t",
"get-function-perfomance-by-name"
]
],
"kind": 31990,
"pubkey": "0002bb00b8e64bb2a03388209b6b9a25c8d745e059abca9b83d166a3fe1edf2c",
"id": "45d841d591dbf0e5c6217d180de7aaf7f4363b4872564b62dc902672e60d95db",
"sig": "2fdac0a0b3650d9a334fb5a9c1409e0ac0b625f95d2a691965dff23363bb3b17e0c6afad064f3d72be92b46613004d5225829377f86f5a2c4ae8fb21092a8b60"
}